home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / mint / tw14w12b.zoo / tw14w12 / toswin.doc < prev    next >
Text File  |  1992-10-30  |  16KB  |  393 lines
  1. TOSWIN: a background program accessory for MiNT
  2. Written by Eric R. Smith (eric.smith@uwo.ca)
  3.  
  4. This version of TOSWIN is copyright 1992 Eric R. Smith. All rights
  5. reserved.
  6.  
  7. TOSWIN is a simple accessory that gives an easy way of running
  8. TOS programs in the background of a GEM session. Selecting this accessory
  9. pops up a window with a scrapbook icon and a menu bar. The menu bar
  10. contains drop down menus; to open a window, select "Open Std Window"
  11. or "Open Alt Window" from the "File" menu. This will pop up a file
  12. selector box; use this box to select the program you want to run. Of
  13. course, this should *not* be a GEM program; you already have a GEM program
  14. running, or you wouldn't be able to get to the accessory. GEM will likely
  15. become horribly confused if there are two programs making GEM calls
  16. simultaneously.
  17.  
  18. Closing the TOSWIN window has the effect of closing the accessory, so
  19. that all windows are hidden. They will all re-appear when "TOS programs"
  20. is selected again from the DESK menu.
  21.  
  22. Closing any other window kills all the programs running in that window.
  23. Be careful!
  24.  
  25. Note that TOSWIN may also be run as an ordinary program; to do this,
  26. just change the extension from '.acc' to '.prg'.
  27.  
  28. MENUS
  29.  
  30. File:
  31.     Open Std Window
  32.     Opens a standard size (i.e. the same size as the line A variables)
  33.     window.
  34.     Open Alt Window
  35.     Opens a different size window. The size defaults to 80x50, but
  36.     this may be changed with the "Set Alt Window Size..." Global
  37.     menu entry.
  38.     Close
  39.     Closes the topmost window.
  40.     Load Config...
  41.     Loads a configuration file previously saved by Save Config...
  42.     TOSWIN looks for a config file called TOSWIN.CNF when starting
  43.     up, and loads it automatically if found.
  44.     Save Config...
  45.     Save the current menu settings and position of the scrapbook icon
  46.     in a file. The user is prompted for whether or not to save
  47.     window positions.
  48.     Set Menu Keys...
  49.     Allows keyboard equivalents to be established for any menu entries.
  50.     Any key (except spacebar) may be used as a menu equivalent, although
  51.     obviously the use of standard ASCII codes would be undesirable :-(.
  52.  
  53.     Quit
  54.     Exit TOSWIN after sending SIGHUP to all child processes.
  55.  
  56. Edit:
  57.     Copy
  58.     Copies the currently selected region in the top window to the
  59.         scrapbook.
  60.     Paste
  61.     Pastes the contents of the scrapbook into the top window.
  62.     Paste Options...
  63.     Controls how data is copied and pasted; for example, whether end
  64.     of line should be sent to applications as a carriage return,
  65.     line feed, or combination.
  66.  
  67. Global:
  68.     Align Windows
  69.     If this is set, TOSWIN will adjust all windows so that the text
  70.     inside them falls on a byte boundary. This should speed up
  71.     the VDI output a bit, at least for fixed width fonts that are
  72.     8 pixels wide.
  73.     Application Menus
  74.     If this option is set, and a window is opened for which an associated
  75.     .MNU file is found, then the application's menu will be loaded and
  76.     displayed in the status line of the window.
  77.     Autoclose
  78.     If this option is set, windows are automatically closed when no more
  79.     processes can send data to them. Otherwise, the string <EXITED>
  80.     is written to the window and it remains open until the user closes
  81.     it manually.
  82.     Flourishes
  83.     If set, grow/shrink boxes appear for windows and dialog boxes.
  84.     Point to type
  85.         If set, input is sent to whatever window the mouse pointer is
  86.     currently over (so you only have to point at a window to type
  87.     into it). Otherwise, input always goes to the top window.
  88.     Smooth Scrolling
  89.     Causes the window contents to be updated more often (after every line)
  90.     if set.
  91.     Set Std Window Size...
  92.     Sets the number of rows and columns for windows opened with the
  93.     "Open Std Window" menu option, or which are run via TOSRUN.
  94.     This option also changes the line A variables to reflect the
  95.     new "standard" size. When specifying a window's rows and
  96.     columns, you may also specify a "scrollback" size. This many rows
  97.     of data are kept around even after they scroll off the top of
  98.     the window, and may be accessed via the vertical scroll bar and
  99.     scroll arrows (or via any keys assigned to the "Gadgets/Scroll Up"
  100.     and "Gadgets/Scroll Down" menu items).
  101.     Set Alt Window Size...
  102.     Sets the number of rows and columns for windows opened with the
  103.     "Open Alt Window"
  104.     Set Default Font...
  105.     Sets the default font for new windows. Any GDOS font may be used
  106.     in a window (this assumes, of course, that you're running GDOS!).
  107.     Even proportional fonts may be used, although they may produce
  108.     strange looking results if used with certain programs :-).
  109.     Set Default Gadgets...
  110.     Sets the default gadgets for new windows. Windows may have no
  111.     gadgets, a title bar (including closer and fuller), or a full
  112.     complement of gadgets including sizer, sliders, arrow, and title
  113.     bar. Windows may also have a menu bar; if a .MNU file is found
  114.     that goes with the program being started in the window, it may
  115.     be loaded and displayed. If no .MNU is found, no menu is displayed
  116.     for this window.
  117.     Environment...
  118.     Instructs TOSWIN about how to set up the environment for new
  119.     processes. The default setting (use ARGV, and set TERM, TERMCAP,
  120.     LINES, and COLUMNS) is the one usually desired.
  121.     Redraw Screen
  122.     Sends a redraw message to all windows, and re-draws the menu
  123.     bar as well.
  124.  
  125. The "Window" and "Gadgets" menus are only applicable to the topmost window,
  126. and since the topmost window is the "TOSWIN" window when the menu is
  127. active, they items in these menus cannot be accessed directly. Instead, you
  128. must use the "Set Menu Keys" option to assign keyboard equivalents for
  129. the menu items below:
  130.  
  131. Window:
  132.  
  133.     Bury Window
  134.         If more than one TOSWIN window is open on screen, a new window
  135.     (i.e. not the current top one) is brought to the top. Repeated
  136.     application will cycle through all open windows.
  137.     Iconify Window
  138.     Make the window small and put it "out of the way". Iconified windows
  139.     may be dragged around without making them bigger; they are
  140.     expanded again by a single click.
  141.     Send Character
  142.     The next character typed will be sent to the application running
  143.     in the top window, regardless of whether the key is a menu
  144.         equivalent or not.
  145.     Set Window Size...
  146.     Change the number of rows and columns for the top window; this probably
  147.     won't change the appearance on screen (unless the new size is
  148.     radically smaller). It will, however, make more or less space available
  149.     via the sliders. Changing the window size causes a SIGWINCH signal
  150.     to be sent to the process group running in the window.
  151.     Set Font...
  152.     Change the font of the top window.
  153.     Set Gadgets...
  154.     Change the gadgets (slider, title, etc.) showing on the top
  155.     window.
  156.  
  157. Gadgets:
  158.  
  159.     Toggle Full
  160.     Has the same effect as clicking on the "full" box of a window.
  161.     Move Window
  162.     A pointing finger appears; move this to the location to which
  163.     you want the window moved, and click the mouse.
  164.     Scroll Up
  165.     Has the same effect as the "up arrow" gadget of a window.
  166.     Scroll Down
  167.     Has the same effect as the "down arrow" gadget of a window.
  168.     Scroll Left
  169.     Has the same effect as the "left arrow" gadget of a window.
  170.     Scroll Right
  171.     Has the same effect as the "right arrow" gadget of a window.
  172.  
  173. WINDOWS
  174.  
  175. Text in a window may be selected by the usual operation of holding down
  176. the mouse button and sweeping out a region. Single clicking on a window
  177. will unselect any text previously selected. Selected text appears in
  178. inverse video. A block of selected text may be dragged to another
  179. (or the same) window; when this is done, the effect is as though
  180. the user typed the selected text at the keyboard while the target window
  181. was on top. Selected text may also be dragged to the clipboard icon to
  182. paste it to the clipboard. Dragging the clipboard icon to a window pastes
  183. the contents of the clipboard into the window.
  184.  
  185. Windows may be resized, moved, etc. with the normal window gadgets, or
  186. with the mouse if the control key is held down. To resize a window without
  187. a sizer box, hold down the control key and press the left mouse button
  188. at the lower r